- 3 minutes to read

ContextPropertiesFilters - System Parameter

This feature aids in complying with information security, hence; you run more securely and faster than ever before

Reduce disk space in the Log Databases.
Remove potentially sensitive data that you do not want Nodinite to store over time.
Increase the overall performance as less data is in the system.
As a result, your database backups also get smaller.
You cannot use Search Fields on data that does not exist (!).

The System parameter ContextPropertiesFilters allows the Logging Service to remove sensitive and unnecessary context properties that just waste disk space in the Log Databases. The Nodinite Log API also rids entries on the fly; e.g. the unwanted data does not even enter the Log Databases.

If there's a match on the name of the context property, then it will be removed during processing, which includes re-index operations.

If the value is null, or the "global" flag Enabled flag is false, context properties are not removed from the system

System Parameter Name Data Type Values/Example Comment
ContextPropertiesFilters json json object as exemplified later on this page Default = null

This feature was introduced with version 6.0.0.11

JSON Structure and Examples

This is an advanced feature; The default is null (DBNULL) meaning the feature is not in use.

Global settings

  • Enabled - Global flag, true or false

Filters array

The Filters array holds the entries to use in the match.

  • RegExFilter - The regular expression, a RegEx (case insensitive). The max time for the processing of each entry is set to 25 milliseconds. Make sure to not use too complex expressions.
  • Description - A handy optional field describing the intent
  • Enabled - Individual entries may be enabled/disabled. You do not have to remove an expression if you are toying with this feature.
{
	"Enabled": true,
	"Filters": [
	{
		"RegExFilter": "pAssWOrd",
		"Description": "This filter removes all context properties with password in the name (case insensitive)",
		"Enabled": true
	},
	{
		"RegExFilter": "http://schemas.microsoft.com/BizTalk/2003/file-properties#SecretKey",
		"Description": "Remove the secret key in use on dynamic send ports",
		"Enabled": true 
	}]
}

Do NOT remove the http://schemas.microsoft.com/BizTalk/2003/system-properties#MessageExchangePattern as this is in use by the Logging Service to process BizTalk Log Events to set a proper Event Direction
Do make use of the power that comes with RegEx, less entries perform better. This is because internal loops perform the filtering.
This feature removes data permanentely. Make sure to know what you are doing!

Frequently asked questions

Additional solutions to common problems and the FAQ for the Nodinite System Parameters exist in the Troubleshooting user guide.

How do I change the value?

Changing a value for the pre-defined System Parameters is described in the generic 'How do I change the System Parameters' article.


Next Step

Administration